home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / sexp110.arc / MEXPORT.DOC < prev    next >
Text File  |  1991-02-22  |  6KB  |  164 lines
  1.  
  2.               MEXPORT  -  MSG Export Utility  V 1.10
  3.                      (c) 1991 by Eric Jacksch
  4.  
  5.  
  6.                         LICENCE AGREEMENT
  7.  
  8.  
  9. This program is released as PostCardWare.  In order to licence 
  10. this utility for use, please send a postcard, preferably of some 
  11. unique local feature to: 
  12.  
  13.  
  14.                            Eric Jacksch
  15.                          MExport Licence
  16.                              Box 1815
  17.                        Kemptville, Ontario
  18.                               Canada
  19.                               K0G 1J0
  20.  
  21.  
  22. and include your name and address.  No fee, no strings, no junk 
  23. mail...I just get some postcards for a change.
  24.  
  25. Please feel free to distribute the archive in it's entire, 
  26. unmodified form.  Should you wish an original intact archive, you 
  27. may request MEXPORT from 1:163/111.
  28.  
  29.  
  30.  
  31.                             OPERATION
  32.  
  33. MExport is a small utility to export messages in a *.msg style 
  34. base.  It is fully redirectable, and thus can be used to export 
  35. the base (or selected messages) to the console, printer, a text 
  36. file, etc.  The syntax is as follows:
  37.  
  38.  
  39. MEXPORT <path> [-s<subject>] [-d<net/node>] [-o<net/node] [-m]
  40.         [-f] [-k] [-r<first>-<last>] [-b<keyword>]
  41.  
  42.  
  43.  
  44. <path>      is the full path to the directory containing the *.msg 
  45.             base,
  46.  
  47. s<subject>  is a string to be compared to the beginning of the subject 
  48.             field of the message,
  49.  
  50. d<net/node> is a network address to be compared to the 
  51.             destination address of the message,
  52.  
  53. o<net/node> is a network address to be compared to the origin 
  54.             address of the message,
  55.  
  56. m           indicates marked mode - the message will only be 
  57.             processed if the times read counter is zero, and 
  58.             then it will be incremented to one. 
  59.  
  60. f           will cause formfeeds to be inserted between messages
  61.  
  62. k           will kill a message after it has been exported
  63.  
  64. r<first>-<last> allows a range to be specified.  Only messages
  65.             between <first> and <last> inclusive are processed.
  66.  
  67. b<keyword>  will search the body of the message for the supplied
  68.             keyword and only export messages which contain the
  69.             keyword.  This function is case insensitive. Underline
  70.             characters, " _ " on the command line will be compared as
  71.             blanks in the message body.  Note that this option
  72.             may result in slower operation.
  73.  
  74. Where selection criteria are specified, the message will only be
  75. exported if it meets all specified criteria.
  76.  
  77.  
  78.                              EXAMPLES
  79.  
  80.  
  81. mexport d:\mail\net >> msg.txt
  82.  
  83.     will export all messages in the base to the text file msg.txt
  84.  
  85.  
  86. mexport d:\mail\net -m >> msg.txt
  87.  
  88.     will export all unread messags in the base to msg.txt and 
  89. then set the times read counter to one.  Using this immediatly 
  90. after unpacking incomming mail and immediately after mail is 
  91. entered locally will cause all mail to be exported once.
  92.  
  93. mexport d:\mail\net -sURGENT -f -m > lpt1
  94.   
  95.     will export any message with a subject line starting with 
  96. URGENT (case insensitive) to lpt1, send a form feed, and then 
  97. mark the message so that this only happens once.  (Please, don't 
  98. forget to use either the -m or -k option in batch file 
  99. applications!)
  100.  
  101. mexport d:\mail\net -d163/111 >> msg.txt
  102.  
  103.     will export all messages in the base which are addressed to 
  104. 163/111 (note that zone is not checked as it is not contained in 
  105. the message header).  This can, of course, be combined with any 
  106. other option, including -m.  Thus, running -d and -m upon 
  107. unpacking incomming mail will log all inbound mail to the 
  108. specified system.
  109.  
  110. mexport d:\mail\net -d163/111 -o163/115 -m -f >> msg.txt
  111.  
  112.     will export any messages from 163/115 which are addressed to 
  113. my system, and it will only do it once.  The F option will also 
  114. cause formfeeds to be inserted between messages.
  115.  
  116. mexport d:\mail\net -r5-10 -bfusion >> msg.txt
  117.  
  118.     will process messages 5 through 10 inclusive and export any having
  119. the keyword "fusion". (Note that this function is case insensitive).
  120.  
  121.  
  122.  
  123.  
  124.                        MEXPORT and MsgTrack
  125.  
  126. For those of you who run MsgTrack by Andrew Farmer at 1:163/115, 
  127. the kill option is an ideal companion to MT's options which will 
  128. move sent and received mail into another directory.  Every night, 
  129. included in a short midnight event, I execute the following,
  130.  
  131. d:
  132. cd \logs
  133. MT
  134. mexport d:\mail\storage -f -k >> d:\logs\netmail.log
  135. daynbr /-1 ren netmail.log netmail.@###
  136.  
  137.  
  138. which causes all mail sent or received that day to be moved into 
  139. an ascii text file, with each message being deleted as it is 
  140. exported, and the file then being renamed using the julian date 
  141. of the day just ended.
  142.  
  143.  
  144.  
  145.  
  146.           BUGS?  SUGGESTIONS?  COMMENTS?  RUDE REMARKS?
  147.  
  148.  
  149. Please netmail me at 1:163/111 with any feedback you might have.
  150.  
  151.  
  152.  
  153.                          SOCIAL STATEMENT
  154.  
  155. Although this utility has the capability to incercept and retain 
  156. copies of in-transit mail, I most strongly discourage sysops from 
  157. using it to do so.  The intent of this program as related to 
  158. netmail is to allow automatic exports of netmail to and from 
  159. *your* system, not in-transit mail.  Even those of you running 
  160. without MsgTrack can limit exports to your *own* mail using a run 
  161. with the -d option after unpacking mail, and the -o option before 
  162. packing mail. 
  163.  
  164.